home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 2: CDPD 1 / Almathera Ten on Ten - Disc 2: CDPD 1.iso / protracker / pt.help.txt < prev    next >
Text File  |  1995-03-15  |  51KB  |  1,646 lines

  1. -------------------------------------------------------------------------
  2. Protracker V1.1 Release B - (C) 1991 Amiga Freelancers    January 6. 1991
  3. -------------------------------------------------------------------------
  4.  
  5. Protracker is a Public Domain program, and may may be copied freely and
  6. included in any PD library. You may not charge anything for the program
  7. other than the cost of the disk and the PD-service.
  8.  
  9. *** This is an printable version of the PT.help file ***
  10.  
  11.  
  12.     Written by:  Lars "ZAP" Hamre
  13.  Layout & Help:  Anders "The Mad Martian" Hamre
  14.  
  15.  
  16.  Thanks must go to the following for contributing with suggestions and
  17.  bug-reports: Burp/Altair, Mr.L/Celtic, King/Amigamafia, Timewalker/PMC, 
  18.  Zyc/Scope, Fix/Cheyens, Eddy/Coast, Tomi Blinnikka, Dr.Awesome/Crusaders,
  19.  Mr.Techno/Abusive, Jarno Seppanen, Fleshbrain/Crusaders and many more.
  20.  
  21.  Helloes go to: Spadge (Go leeds, go!), Ray Burt-Frost/Amiganuts United,
  22.  Micro-Pal/Jamie Principal, Batman/Miranda, Dr.Outtasight/Crusaders,
  23.  El Cubo/Crusaders and Mellow-D.
  24.  
  25.  Hi there music lovers!
  26.  
  27.  We finally made it; Protracker v1.1 has come to stay! At last we can be
  28.  proud of saying that it is the best!
  29.  
  30.  There has been a lot of changes this time, especially to get Protracker to
  31.  work properly with hi-tech amigas and Kickstart 2.0. And it does! (as far
  32.  as we know, at least). 
  33.  Don't hesitate to contact us if you can't get it working or there's some-
  34.  thing you can't figure out.
  35.  
  36.  Some technical info:
  37.  
  38.    Sourcecode: 340k / 19500 lines
  39.  Main Program: 147k
  40.      GFX data: 50k (packed)
  41.      Worktime: 9958654985476 hours
  42.      ASM time: about 2.35 minutes    
  43.  
  44.  "I hate this!"
  45.  --------------
  46.  Zap had quite a job this time, and  since we don't have more coders,
  47.  and he's extraordinarely lazy, it was hell on earth. We lost the source
  48.  about 12-13 times and much time was lost on recovering it, but thanks to
  49.  a couple of backups, it all ended well.
  50.  
  51.  You're looking at the result now. :-)
  52.  What do you think?!
  53.  
  54.  Protracker finally deserves to be  called "the best tracker around",
  55.  which many of you have been calling it in your psychotic letters to us... 
  56.  
  57.  One thing that surprised us though,  was the fact that all of you said
  58.  it was "great", "superb" and so on.
  59.  
  60.  Very few (Noone!) complained or came up with new, original ideas and/or 
  61.  useful features! Most of the things in PT1.1 are self-invented, but thanks
  62.  must go to numerous guys in Finland who constantly have been bombarding
  63.  our mailbox. Thanks guys, you really are a great bunch of people!
  64.  
  65.  Hi Sami! Thanks for the chocolate! I'll send you some in return, ok?!
  66.  
  67.  Markus: Keep them letters coming! (BTW: We STILL can't find that bug!)
  68.  
  69.  Mika: Veeeeery sorry for the *LONG* delay, but we managed to lose your        
  70.  letter, and I just found it a few weeks ago; under my guinea-pig's cage!
  71.  
  72.  Yeah I know. I'm not supposed to use this space for my personal greetings,
  73.  right? Sorry guys, but I just had to, since Amiga Freelancers don't make
  74.  demos and therefore there are no scrollers for me to write crap in!
  75.  
  76.  Okokokokok. I'll cut it out now. Here's our address...
  77.  
  78.  Something you'd like in the next version of Protracker? Have you found
  79.  any bugs? Or do you just want to play tic-tac-toe by mail?
  80.  
  81.           Anyway, write to:
  82.  
  83.           Amiga Freelancers
  84.           Bekkeliveien 10
  85.           N-2010 Str0mmen
  86.           Norway
  87.  
  88.          (No games, please!)
  89.  
  90.  Amiga Freelancers are:
  91.  
  92.             Lars "Zap" Hamre               (Coding, Music, Hardware)
  93.      Anders "The Mad Martian" Hamre            (Gfx, Sfx, Music)
  94.          Sven "The Moose" Vahsen                  (Coding...)
  95.          Rune "Quantarc" Johnsrud                (Gfx, Fonts)
  96.  
  97.  Planned release date for pt v1.2:  Haven't got the foggiest idea...
  98.  
  99.  
  100.  
  101.                MAINSCREEN
  102.                ----------
  103.  ## PLAY ##
  104.  Will play the song from the current position in the song. The pointer
  105.  turns yellow, just to show you what's going on.
  106.  
  107.  ## PATTERN ##
  108.  Will play the current pattern which is shown at the bottom of the screen.
  109.  The pointer turns yellow here as well. Holding down the right button while
  110.  pressing play or pattern will play from the current patternposition.
  111.  
  112.  ## EDIT ##
  113.  Will put you in edit mode. The pointer turns blue, and you can enter notes
  114.  and numbers from the keyboard. Use the arrowkeys to move up/down and
  115.  left/right in the pattern. Entering a note or a number will cause the
  116.  pattern to jump one or more slots down.
  117.  
  118.  ## RECORD ##
  119.  Will put you in edit mode, but also play the current pattern or song.
  120.  You can select this in the Edit Options menu. While the pattern or
  121.  song is playing, you can type in notes and numbers from the keyboard,
  122.  and they will appear in the pattern as it scrolls. The notes and numbers
  123.  will also be quantized to the nearest slot, so that keeping a steady rhythm
  124.  is no problem. The pointer will turn blue here as well as in the the normal
  125.  edit mode.
  126.  
  127.  ## STOP ##
  128.  Will stop playing of songs and patterns, recording, and will turn edit
  129.  mode off.
  130.  
  131.  ## CLEAR ##
  132.  Will first ask you what you want to clear. You can clear either all,
  133.  song or samples.
  134.  
  135.  ## EDIT OP. ##
  136.  Will exchange the Spectrum Analyzer with the Edit Menu(s). Pressing more
  137.  than one time will browse through the edit op. screens.
  138.  
  139.  ## DISK OP. ##
  140.  Will go to the File Requester.
  141.  
  142.  ## PLST ##
  143.  Will go to the PLST screen.
  144.  
  145.  ## PSET-ED ##
  146.  Will go to the preset editor.
  147.  
  148.  ## Setup ##
  149.  Will go to the Setup Screen.
  150.  
  151.  ## Sampler ##
  152.  Will go to the Sampler screen.
  153.  
  154.  The small gadgets labeled
  155.  
  156.  ## 1, 2, 3 and 4 ##
  157.  represent the audiochannels of your amiga. When lit, that channel is on.
  158.  When not lit, the channel is muted and and the notes in that track will
  159.  not be played.
  160.  
  161.  You can also use ctrl-a to toggle an audiochannel, and ctrl-q to unmute all
  162.  channels. Ctrl+shift-a will solo the current channel.
  163.  
  164.  ## Tempo ##
  165.  The tempo gadget on the status bar is for setting the CIA speed, if CIA
  166.  timing is used. The gadget will be updated every time you set the speed
  167.  using the F command (if CIA that is).
  168.  
  169.  
  170.  
  171.                 DISK OP.         V1.1:
  172.                 --------
  173.  Delete Song/Module/Sample changed to one gadget: Delete file.
  174.  
  175.  Directories shown/Parent gadget.
  176.  
  177.  Path indicator arrow. Click to change paths without reading dir.
  178.  
  179.  Clicking on "free" will show you free diskspace also without reading dir.
  180.  
  181.  Dir-browse button and lots more...
  182.  
  183.  ## Path ##
  184.  The paths for songs, modules and samples can now be changed, and they
  185.  can be up to 31 characters long. To change path, click on load song/ 
  186.  module/sample or use the arrow indicating what path you're at.
  187.  
  188.  ## Free (Diskspace) ##
  189.  Free diskspace can be shown in hex or decimal. Select this on the setup
  190.  screen. Click on "free" to get free diskspace without re-reading the dir.
  191.  
  192.  ## Format Disk ##
  193.  Will format a disk in df0: (Hopefully still bug-free...)
  194.  
  195.  ## Rename file ##
  196.  Will dir the current directory. Select a filename, and you will
  197.  be able to edit the name.
  198.  
  199.  ## Delete file ##
  200.  Will dir the current directory. Select a file, and it will be deleted
  201.  from the disk.
  202.  
  203.  ## Pack ##
  204.  When on, protracker will pack songs before saving (Modules can not be
  205.  packed in this version, sorry!).
  206.  
  207.  ## Load song ##
  208.  Will dir the songs path. Select a song, and it will be loaded and
  209.  decrunched if crunched.
  210.  
  211.  ## Save song ##
  212.  Will pack the song if pack is on, then save it to the current songs
  213.  path. Remember to enter a name for your song, otherwise pt will not save!
  214.  
  215.  ## Load module ##
  216.  Will dir the modules path. Select a
  217.  module, and it will be loaded.
  218.  
  219.  ## Save module ##
  220.  Will save the module to the current modules path. Modules can be saved
  221.  without a name, since they always begin with "Mod.".
  222.  
  223.  ## Load sample ##
  224.  Will dir the sample path. Select a sample, and it will be loaded to the
  225.  current sample. IFF headers will be chopped off and loops loaded, if any.
  226.  
  227.  ## Save Sample ##
  228.  Will save the current sample as RAW or IFF. Select this in the "Save"
  229.  gadget to the right of "Load Sample". IFF loops will be saved too.
  230.  
  231.  ## Dir-Browse button ##
  232.  By pressing this button you can browse through various preset paths, so
  233.  that you won't have to enter them over and over again.
  234.  
  235.  AutoDir - If you set the autodir toggle on the setup screen
  236.            to on, protracker will automatically dir the current
  237.            path when you enter the disk op. screen.
  238.  
  239.  AutoExit - When this toggle is on protracker will exit from
  240.             disk op. when loading a song or a module.
  241.  
  242.  
  243.  
  244.  
  245.                   PLST
  246.                   ----
  247.  The PLST is fairly simple to use. Listed here are all the samples in
  248.  your Presetlist and their lengths. Just click on a name, and Protracker
  249.  will ask for a disk called ST-01 through to ST-FF. Insert it, and the
  250.  chosen sample will be loaded to the current sample displayed at the
  251.  left of the screen. Use the up/down arrow keys to move up and down in the
  252.  PresetList. If you press shift or the right mousebutton, the PLST will
  253.  move 10 presets at a time.
  254.  
  255.  At the top the PLST shows the total number of samples from the selected
  256.  sounddisks. There are a few PLST gadgets:
  257.  
  258.  ## CLEAR ##
  259.  Will clear all the sounddisk names you have entered, and display the whole
  260.  PresetList.
  261.  
  262.  ## MOUNTL(ist) ##
  263.  Will search your drives for disks called ST-**, and put the names into
  264.  the ST-__ gadgets. ST-00 will not be mounted.
  265.  
  266.  ## ST-__ ##
  267.  There are three ST-__ gadgets where you can enter the numbers of the
  268.  sounddisks you want to display in the PLST. Only the presets from the
  269.  selected sounddisks will be shown. If you clear all gadgets (by pressing
  270.  return or right mousebutton), or press "Clear", the PLST will revert
  271.  to show all presets.
  272.  
  273.  
  274.  
  275.                 PRESET ED
  276.                 ---------
  277.  The protracker's preset-editor is an enhanced version of the original v2.5
  278.  editor. The screen has been cleaned up, and redrawn to match the plst.
  279.  The editing is still a bit lousy though, but we promise to fix it up
  280.  a bit in v1.2...
  281.  
  282.  You can now save the finetune value in the presetlist instead of volume.
  283.  
  284.  The preset editor is used for sorting and catalogueing your samples. All
  285.  samples for use with protracker should be on disks called "ST-01" to
  286.  "ST-FF". When adding a disk to the presetlist, only these disks are
  287.  recognized.
  288.  
  289.  Harddisk owners may want to add a directory. e.g. You've got a directory
  290.  called "Supersamples", and you want to use the samples on pt... Simple.
  291.  Assign "Supersamples" to ST-13 or whatever. In the box with "Disk:"
  292.  and ST-__ in it, enter ST-13. Now enter "DHX:supersamples" in the
  293.  path box and press "add path".
  294.  
  295.  The path will be added as ST-13 in your presetlist, so everytime you need
  296.  a sample from ST-13, it will be loaded from "Supersamples" instead. Simple?
  297.  
  298.  Editing
  299.  --------
  300.  We must admit the editing is lousy, but you can't have everything!
  301.  To edit a preset, simply click on it. Use the arrowkeys to move left/right.
  302.  
  303.  When moving up and down in the presetlist, use shift or the right mouse-
  304.  button to speed it up a bit.
  305.  
  306.  ## add path ##
  307.  Will add the current path to the presetlist. infofiles will not be added.
  308.  Samplenames can only be 15 chars long.
  309.  
  310.  ## Insert Preset ##
  311.  Will create a new preset. Enter the data for the sample, and it will be
  312.  added to the presetlist.
  313.  
  314.  ## Delete Preset ##
  315.  Will delete the wanted preset from the presetlist.
  316.  
  317.  ## Delete Disk ##
  318.  Will delete the disknumber set in the "Disk:" box.
  319.  
  320.  ## PATH ##
  321.  This is where you enter the path to be added from. It can be up to 31
  322.  characters long (should be enough!?).
  323.  
  324.  ## Disk ##
  325.  This is the disk (or HD-dir) that's being added from (or deleted).
  326.  
  327.  ## Presets ##
  328.  This is the current number of presets in the presetlist.
  329.  
  330.  ## Clear PLST ##
  331.  Will clear all the presets.
  332.  
  333.  ## Load PLST ##
  334.  Will load the presetlist from a file called "PLST". This file should be
  335.  placed in the PTdir (See setup2).
  336.  
  337.  ## Save PLST ###
  338.  Will save the presetlist as a file called "PLST" to the current PTdir.
  339.  
  340.  ## Print PLST ##
  341.  Will print the presetlist to the current print path, shown on the
  342.  setup-screen. 
  343.  
  344.  ## PLST ##
  345.  Will go to the PLST-screen!
  346.  
  347.  ...and in case you were too stupid to understand, PLST is a shortform for
  348.  "Presetlist"!
  349.  
  350.  
  351.  
  352.  
  353.                 Sampler
  354.                 -------
  355.  The new sampler/sample editor was included simply because we thought 
  356.  the one in Noisetracker 2.0 was terrible, and we needed graphing of
  357.  samples and proper loop editing. 
  358.  
  359.  It's very fast, much faster than Audiomaster, and the editing is
  360.  much simpler. 
  361.  
  362.  We also included a resampling option which we hope you'll find useful.
  363.  
  364.  Editing
  365.  -------
  366.  When editing a sample, use the mouse to set the cursorline and to mark
  367.  ranges.
  368.  
  369.  ## Waveform ##
  370.  Will play the full sample with loops.
  371.  
  372.  ## Display ##
  373.  Will play the part of the sample being shown on screen.
  374.  
  375.  ## Range ##
  376.  Will play the marked range.
  377.  
  378.  ## Stop ##
  379.  Will stop all playing of samples.
  380.  
  381.  ## Show range ##
  382.  Will magnify the current range and display it.
  383.  
  384.  ## Show all ##
  385.  Will display the whole sample.
  386.  
  387.  ## Beg ##
  388.  Will put the cursorline at the beginning of the sample.
  389.  
  390.  ## End ##
  391.  Will put the cursorline at the end of the sample.
  392.  
  393.  ## Swap buff(er) ##
  394.  The swap the current sample with the copy-buffer.
  395.  
  396.  ## Zoom out ##
  397.  Will show double the range you are displaying.
  398.  
  399.  ## Range all ##
  400.  Will range the part of the sample being displayed on screen.
  401.  
  402.  ## Cut ##
  403.  Will cut away the part of the sample that's marked.
  404.  
  405.  ## Copy ##
  406.  Will copy the marked range to the copy-buffer.
  407.  
  408.  ## Paste ##
  409.  Will paste the copy-buffer into the current sample.
  410.  
  411.  
  412.  The volume box
  413.  --------------
  414.  The volume box is a bit like Audiomaster's, only better.
  415.  
  416.  Set the "from" and "to" volume percentages by using the sliders,
  417.  or just type in any number you please (from 0 to 200) in the
  418.  percentage boxes to the right.
  419.  
  420.  ## Normalize ##
  421.  Will find the highest volume settings possible (without clipping).
  422.  
  423.  ## Cancel ##
  424.  Will exit the volume box.
  425.  
  426.  ## \ ##
  427.  Will set the percentages 100%-0%
  428.  
  429.  ## / ##
  430.  Will set the percentages 0%-100%
  431.  
  432.  ## - ##
  433.  Will set the percentages 100%-100%
  434.  
  435.  ## Ramp ##
  436.  Will ramp (calculate) the volume!
  437.  
  438.  ## Tunetone ##
  439.  Will create a sinus sound, which you can tune your samples after.
  440.  See setup 2 help for details.
  441.  
  442.  ## Sample ##
  443.  Will first enter the monitor screen. Now click right button to sample,
  444.  left to exit. 
  445.  
  446.  ## Note ##
  447.  This is the note to sample on. Range is C-1 to B-3.
  448.  
  449.  ## Resample ##
  450.  The resampling option is much easier to use than the one in Audiomaster.
  451.  Here's a step-by-step explanation:
  452.  
  453.  1. Turn on the tuning tone.
  454.  2. Use the keyboard to find what note it is. Use finetune if needed.
  455.  3. Enter the note in the "Note:" box to the right. 
  456.  4. Press resample!
  457.  
  458.  ## Note ##
  459.  This is what note to resample to.
  460.  
  461.  ## Disp(lay) ##
  462.  This is the length of the part of the sample being shown on screen.
  463.  
  464.  ## Loop on/off ##
  465.  This is for turning loops on/off without having to fiddle with the
  466.  repeat and replen gadgets.
  467.  
  468.  ## Exit ##
  469.  Exits the sampler screen. 
  470.  
  471.  
  472.  
  473.                  SETUP
  474.                  -----
  475.  The setup screens were provided so that PT users could set up their own
  476.  personal environment. We hope we have satisfied most of you. You've got 8
  477.  on/off toggles, a split keyboard editor, a color palette and lots
  478.  more. Choose what you want, and use "Save Config" to save your environ-
  479.  ment. On the next screen is a list of what will be saved in the config
  480.  file.
  481.  
  482.  V1.1: Click "2" to enter setup screen 2, with lots of new features!
  483.  
  484.  
  485.  This will be saved in the config file:
  486.  --------------------------------------
  487.  Songs/Modules/Samples and Print paths, Split Keyboard data, Accidental,
  488.  MultiKey Channeltable, Colors, Keyrepeat, the 8 on/off toggles,
  489.  the 8 external dos commands and the effect macros + everything in setup 2.
  490.  
  491.  You can have up to 256 different config files. They will be saved
  492.  as "pt.config-00", "pt.config-01" and so on. Set the confignumber
  493.  in the "cnfig" box.
  494.  
  495.  ## Load config ##
  496.  Will load the selected config file.
  497.  
  498.  ## Save config ##
  499.  Will save the selected config file.
  500.  
  501.  ## Reset All ##
  502.  Will set the original PT defaults and colors.
  503.  
  504.  ## Multi ##
  505.  This table is used with the multi keyboard option. The four numbers repre-
  506.  sent what channel each channel will jump to next. 1-2, 2-3, 3-4 and so on.
  507.  
  508.  ## The dot ##
  509.  The gadget with a dot and a textline can be used to execute dos commands.
  510.  Each of the 8 commands can be up to 31 letters long. Pressing the dot will
  511.  browse through the commands. Holding the right button and pressing it will
  512.  execute the command. Note that PT needs the command "run" to execute the
  513.  other commands. This is because of commodore's stupid programming of the
  514.  dos library function "execute". Type "endcli" to go back to protracker.
  515.  
  516.  ## The Color Palette ##
  517.  The color palette is simple to use. Just select a color, and use the R,
  518.  G and B sliders to set the color.
  519.  
  520.  ## Undo ##
  521.  Will put back the latest change.
  522.  
  523.  ## Cancel ##
  524.  Will set the config colors.
  525.  
  526.  ## Def(ault) ##
  527.  Will set the original ST colors.
  528.  
  529.  ## Split ##
  530.  You can set 4 splits on the keyboard, each with it's own sample, splitpoint
  531.  and transpose. Just type in a sample number and select the key to split
  532.  at by pressing the appropriate one.
  533.  The transpose note for each split is the first note in that split-range.
  534.  Notes below the first split will be played with the current sample.
  535.  Split is great for recording drums, or for playing untuned samples in tune
  536.  (use together with finetune).
  537.  
  538.  ## Clear ## will clear the splits.
  539.  
  540.  ## KeyRep(eat) ##
  541.  The first number is the keyrepeat delay, and the second is the speed.
  542.  
  543.  ## Accidental ##
  544.  Simple enough, accidental allows you to select sharp (#) or flat (¡) notes.
  545.  This will not be saved with the song!
  546.  
  547.  ## Print Song ##
  548.  Will print the song to the path shown below the "Print Song" gadget.
  549.  The print path can be 31 chars long.
  550.  
  551.  ## Split on/off ##
  552.  Toggles between normal and split keyboard.
  553.  
  554.  ## Filter on/off ##
  555.  Toggles the audiofilter / PowerLED.
  556.  (Not available on all Amigas)
  557.  
  558.  ## Trans(pose)del(ete) on/off ##
  559.  When on, notes transposed out of range will be deleted.
  560.  
  561.  ## ShowDec(imal) ##
  562.  When on, Freemem, Tunemem, and filelengths will be shown in decimal.
  563.  
  564.  ## Autodir on/off ##
  565.  When on, protracker dirs the current directory path automatically.
  566.  
  567.  ## AutoExit on/off ##
  568.  When on, protracker will automatically exit from the file requester when
  569.  loading a song or module.
  570.  
  571.  ## Mod. only on/off ##
  572.  When on, protracker will only show modules beginning with "mod.".
  573.  
  574.  ## MIDI on/off ## 
  575.  Enables midi input (see midi help).
  576.  
  577.  
  578.  
  579.              Setup 2
  580.              -------
  581.  
  582.  Setup 2 is basically full of the things we couldn't fit into Setup 1
  583.  in Protracker 1.0 + a few things people thought we should include.
  584.  
  585.  Well, hope you're satisfied with the result guys...
  586.  
  587.  Click on "1" to go back to good ol' setup 1...
  588.  
  589.  
  590.  ## Timing ##
  591.  We included this so that American  users also could enjoy protracker, 
  592.  and wouldn't have to use sonix or any other terrible music program...
  593.  
  594.  You can choose between CIA or Vblank timing. Vblank is the timing-method
  595.  soundtrackers have been using since the dawn of time, while CIA is a much
  596.  better and accurate timing with the tempo measured in beats per minute.
  597.  Using Vblank on NTSC amigas will cause the song to play 20% faster.
  598.  With CIA, there's no difference.
  599.  
  600.  ## Tempo ##
  601.  This is where you set your default CIA timing tempo. Range: 32-255.
  602.  
  603.  ## Speed ##
  604.  This is where you set your default Vblank timing speed. Range: 01-FF.
  605.  
  606.  ## Copper Editor ##
  607.  The copper editor is for altering the colors of the VU-meters and the
  608.  spectrum analyzer to your own liking. Select a color by clicking somewhere
  609.  within the coppered stripe. Now use the R, G and B sliders to
  610.  alter the color.
  611.  
  612.  ## Spread ##
  613.  Will create an even gradient between the current color and the one you
  614.  click on next.
  615.  
  616.  ## arrows ##
  617.  Will rotate the whole copper stripe in the Y-axis (up/down).
  618.  
  619.  Undo, cancel and def(ault) will work just like in the palette 
  620.  in setup 1.
  621.  
  622.  ## Mods ##
  623.  This is where you set your default modules path.
  624.  
  625.  ## Songs ##
  626.  This is where you set your default songs path.
  627.  
  628.  ## Sampl(es) ##
  629.  This is where you set your default sample path.
  630.  
  631.  ## PTdir ##
  632.  This is the path for the helpfile, the PLST and the PT configfile(s).
  633.  
  634.  ## Max PLST ##
  635.  This is the maximum number of presets in your presetlist.
  636.  
  637.  ## DMA wait ##
  638.  Use this on fast amigas to slow down the DMA enough to not miss any notes.
  639.  If you set a too low value, you will miss some of the low notes!
  640.  If you set a too high value, everything will be slowed down.
  641.  300 or a little less is ok on a normal A500 7.09 MHz (PAL).
  642.  900 (approx.) is ok on an A3000 running at 25Mhz.
  643.  
  644.  ## Tuning tone ##
  645.  The tuning tone is for use with the sample editor. The note is what note
  646.  to play the tuning tone at, and the number is the volume.
  647.  
  648.  Salvage doesn't work...sorry...
  649.  
  650.  ## <- Default ##
  651.  Will put back the default for everything in the middle column.
  652.  
  653.  ## Override ##
  654.  When on, PT will ignore any paths or disknames when loading a song
  655.  or module. All the samples will be loaded from the current sample
  656.  path.
  657.  
  658.  ## Nosamples ##
  659.  When on, PT won't load the samples when loading a song or module.
  660.  
  661.  ## BlankZero ##
  662.  When on, PT won't show the first zero in the samplenumber, as on NT1.2.
  663.  
  664.  ## Show dirs ##
  665.  When on, directories will be shown in Disk Op.
  666.  
  667.  ## Show Publ(ic) ##
  668.  When on, PT will show all free memory, not just chip-mem.
  669.  
  670.  ## Cut to buff(er) ##
  671.  When on, all samples cut in the sample editor will to put in the
  672.  copy-buffer.
  673.  
  674.  ## Load loop ##
  675.  When on, PT will load loops from IFF-samples.
  676.  
  677.  ## Slow Mode ##
  678.  When on, text editing, gadget-repeats, etc. will go much slower. Use this
  679.  if you have a 25 MHz A3000 or any other fast computer. We will try to do
  680.  an automatic speed check in the next version (1.2).
  681.  
  682.  
  683.  
  684.  
  685.                  MIDI
  686.                  ----
  687.  Midi routines in protracker 1.1 are still very limited. Midi in should 
  688.  work ok, though. To activate midi, you'll have to turn it on on the 
  689.  setup1 screen. Use the three upper octaves on your synthesizer to play
  690.  notes. Some keys in the lowest octave can be used to play/stop/record etc.
  691.  
  692.  We might fix better midi support in later versions of protracker, but so
  693.  far, this is uncertain... Read the PT.ReadMe! file for more info.
  694.  
  695.  
  696.  
  697.  
  698.                 EDIT OP.
  699.                 --------
  700.  
  701.  The edit op. screens were just a handy way for us to implement all the new
  702.  functions we had thought of. There are three screens, and you can browse 
  703.  through them by pressing the edit op.  gadget more than once, or select one
  704.  by clicking on the numbers 1-3. 
  705.                
  706.  To exit edit op., click on the gadget labeled "E" or press ESC.
  707.  
  708.  
  709.  Edit op. Screen 1:
  710.  
  711.  ## Transposing ##
  712.  
  713.  What is transposing ?
  714.  
  715.  Transposing lets you shift the pitch of the notes up or down. 
  716.  E.g. Change a C-3 to a C#3.
  717.  
  718.  In comparison to other trackers, protracker lets you transpose in just
  719.  about every way you can imagine. You can transpose either the current
  720.  sample or all the samples in a track or pattern.
  721.  
  722.  To the right of the title bar is a small box with the letter "S" or "A".
  723.  
  724.  S - Only the current sample will be transposed. 
  725.  A - All the samples from $00-$1F will be transposed. V1.1: Now bugfree!
  726.  
  727.  To toggle between the two, click on the edit op. title bar.
  728.  
  729.  If the setup toggle "TransDel" is on, all the notes transposed out of range
  730.  (C-1 to B-3) will be deleted. If not, they will not be transposed.
  731.  
  732.  
  733.  
  734.  Edit op. screen 2: (Record)
  735.  
  736.  ## Record ## 
  737.  Patt - Record current pattern only. 
  738.  Song - When recording, pt will move through the patterns in the
  739.         song, just like normal play.
  740.  
  741.  ## Quantize ##
  742.  Will move the notes you record to every n'th slot. Entering 00 will 
  743.  turn off the quantizing, and the notes you play will always be 
  744.  inserted at the patternposition you are at. Entering 01 will quantize
  745.  the notes the the nearest slot according to the speed. i.e. if you 
  746.  play a note after the first half has been played, it will be quantized
  747.  to the slot below. Entering a value like 8 will quantize to every 8th
  748.  note, and so on. Got that? 
  749.  
  750.  ## Metro(nome) ##
  751.  The first number is the speed of the metronome, and the second is the 
  752.  channel to play it on. The Sample used for metronomes is always sample
  753.  $1F. Load your own favourite metronome sample. The metronome will always
  754.  be played at C-3, but you can still change the volume and loop values. 
  755.  To turn off the metronome, just set the speed or channel to 00. 
  756.  
  757.  ## Multi ##
  758.  When on, pt will jump to another channel after you play a note on the
  759.  keyboard. This makes it possible to play two or more notes at the same
  760.  time (very useful with midi). On the setup screen you can choose what
  761.  channel to jump to after playing a note.
  762.  
  763.  
  764.  
  765.  Edit Op. screen 2: (Samples)
  766.  
  767.  To the right of the title bar is a small box with the letter "T", "P"
  768.  or "S".
  769.  
  770.  T - Copy & Exchange apply to current track only.
  771.  P - Copy & Exchange will affect the the whole pattern.
  772.  S - Copy & Exchange will apply to the real samples in memory.
  773.  
  774.  To toggle between the two, click on the edit op. title bar.
  775.  
  776.  ## Delete ##
  777.  Will delete all notes with the current sample in current track or whole
  778.  pattern.
  779.  
  780.  ## Kill ##
  781.  Will kill the current sample. That is, remove it from memory and reset
  782.  all sample settings. It will not be deleted from the track or pattern.
  783.  You can also use the period (.) key on the numeric keyboard to invoke
  784.  this function.
  785.  
  786.  ## EXCHGE (Exchange) ##
  787.  Will exchange the samplenumber shown in the "from" gadget with the sample-
  788.  number in the "to" gadget and vice versa. "T" or "P" selects track or
  789.  pattern. "S" exchanges the samples.
  790.  
  791.  ## MOVE ##
  792.  Will move the samplenumber shown in the "from" gadget to the sample-
  793.  number in the "to" gadget.
  794.  
  795.  
  796.  
  797.  Edit Op. screen 3: (Sample Editor)
  798.  
  799.  To the right of the title bar is a small box with the letter "H" or "C".
  800.  
  801.  H - Will halve the volume when mixing and echoing to avoid clipping.
  802.  C - Will not halve the volume. The sample may be clipped.
  803.  
  804.  To toggle between the two, click on the edit op. title bar.
  805.  
  806.  ## Mix ## 
  807.  Will mix one sample with another. Pt asks you which two samples to be
  808.  mixed, and where to put the result.
  809.  
  810.  Holding the right button and pressing mix will mix the current sample with
  811.  itself. You can offset the sample by setting a position in the "pos" gadg.
  812.  If you set "mod" to a non-zero value, the sample will also be modulated. 
  813.  
  814.  ## Echo ##
  815.  Will create a echo effect on the current sample. Use "pos" to set the 
  816.  delay time of the echo. If you want more room to echo in, just turn up
  817.  the length of the sample.
  818.  
  819.  ## Boost ##
  820.  Will turn up the treble of the sample. Use this on hi-hats and snares!
  821.  
  822.  ## Filter ##
  823.  Will Delta-filter the sample. Use this on noisy basses.
  824.  
  825.  ## X-Fade ##
  826.  Will crossfade the sample (mix with itself, backwards). Handy for looping
  827.  samples that are hard to loop.
  828.  
  829.  ## Backwd (backwards) ##
  830.  Will turn the sample backwards!
  831.  
  832.  ## Upsample ##
  833.  Will remove every second byte of the sample, halving the length and 
  834.  shifting the pitch one octave up.
  835.  
  836.  ## Downsample ##
  837.  Will double every byte of the sample, doubling the length, and shifting
  838.  the pitch one octave down. If you downsample samples longer than $7FFE, 
  839.  you will lose the end of them. 
  840.  
  841.  ## POS ##
  842.  This is just an offset in the sample, used for a lot of things.
  843.  
  844.  ## MOD ##
  845.  This is used for modulation. Press "MOD" to modulate the current sample.
  846.  
  847.  ## Cutbeg(inning) ##
  848.  Will chop the number of bytes set in the "pos" gadget off the beginning of
  849.  the sample.
  850.  
  851.  ## FU (Fade Up) ##
  852.  Will fade the volume from 0 to 100%. Use "Pos" to select where in the
  853.  sample to fade up to.
  854.  
  855.  ## FD (Fade Down) ##
  856.  Will fade the volume from 100 to 0%. Use "Pos" to select where in the
  857.  sample to fade down from.
  858.  
  859.  ## VOL ##
  860.  With this you can change the "real" volume of the sample. Just set a
  861.  percentage and press "VOL".
  862.  
  863.  Edit Op.3 is now intended to be used with the new sample-editor. If a 
  864.  range is marked, some of the functions apply to the range only. If there's
  865.  no range marked, the functions will affect the whole sample. You may also
  866.  set "POS" by clicking on the sample and setting the cursor-line.
  867.  
  868.  
  869.  
  870.  
  871.              EFFECT COMMANDS
  872.              ---------------
  873.  
  874.  Effect commands on protracker should
  875.  be compatible with all other trackers.
  876.  
  877.  0 - None/Arpeggio      8 - * NOT USED *
  878.  1 - Portamento Up      9 - SampleOffset
  879.  2 - Portamento Down    A - VolumeSlide
  880.  3 - TonePortamento     B - PositionJump
  881.  4 - Vibrato            C - Set Volume
  882.  5 - ToneP + VolSlide   D - PatternBreak
  883.  6 - Vibra + VolSlide   E - Misc. Cmds
  884.  7 - Tremolo            F - Set Speed
  885.  
  886.               E - COMMANDS
  887.               ------------
  888.  
  889.  The E command has been altered to contain more commands than one.
  890.  
  891.  E0- Filter On/Off      E8- * NOT USED *
  892.  E1- Fineslide Up       E9- Retrig Note
  893.  E2- Fineslide Down     EA- FineVol Up
  894.  E3- Glissando Control  EB- FineVol Down
  895.  E4- Vibrato Control    EC- NoteCut
  896.  E5- Set Finetune       ED- NoteDelay
  897.  E6- Patternloop        EE- PatternDelay
  898.  E7- Tremolo Control    EF- Invert Loop
  899.  
  900.  
  901.  
  902.  Cmd 0. Arpeggio [Range:$0-$F/$0-$F]
  903.  -----------------------------------
  904.  Usage: $0 + 1st halfnote add
  905.            + 2nd halfnote add
  906.  
  907.  Arpeggio is used to simulate chords. This is done by rapidly changing the
  908.  pitch between 3(or 2) different notes. It sounds very noisy and grainy on
  909.  most samples, but ok on monotone ones.
  910.  
  911.  Example: C-300047  C-major chord: (C+E+G  or C+4+7 halfnotes)
  912.  
  913.           C-300037  C-minor chord: (C+D#+G or C+3+7 halfnotes)
  914.  
  915.  
  916.  
  917.  Cmd 1. Portamento up [Speed:$00-$FF]
  918.  ------------------------------------
  919.  Usage: $1 + portamento speed
  920.  
  921.  Portamento up will simply slide the sample pitch up. You can NOT slide
  922.  higher than B-3! (Period 113)
  923.  
  924.  Example: C-300103  1 is the command, 3 is the portamentospeed.
  925.  
  926.  NOTE: The portamento will be called as many times as the speed of the song.
  927.  This means that you'll sometimes have trouble sliding accuratly. If you
  928.  change the speed without changing the sliderates, it will sound bad...
  929.  
  930.  
  931.  
  932.  Cmd 2. Portamento down [Speed:$00-FF]
  933.  -------------------------------------
  934.  Usage: $2 + portamento speed
  935.  
  936.  Just like command 1, except that this one slides the pitch down instead.
  937.  (Adds to the period).
  938.  
  939.  You can NOT slide lower than C-1! (Period 856)
  940.  
  941.  Example: C-300203  2 is the command, 3 is the portamentospeed.
  942.  
  943.  
  944.  
  945.  Cmd 3. Tone-portamento [Speed:$00-$FF]
  946.  --------------------------------------
  947.  Usage: Dest-note + $3 + slidespeed
  948.  
  949.  This command will automatically slide from the old note to the new.
  950.  You don't have to worry about which direction to slide, you need only set
  951.  the slide speed. To keep on sliding, just select the command $3 + 00.
  952.  
  953.  Example: A-200000  First play a note.
  954.           C-300305  C-3 is the note to slide to, 3 the command,
  955.                     and 5 the speed.
  956.  
  957.  
  958.  
  959.  Cmd 4. Vibrato [Rate:$0-$F,Dpth:$0-$F]
  960.  --------------------------------------
  961.  Usage: $4 + vibratorate + vibratodepth
  962.  
  963.  Example: C-300481  4 is the command, 8 is the speed of the vibrato,
  964.                     and 1 is the depth of the vibrato.
  965.  
  966.  To keep on vibrating, just select the command $4 + 00. To change the
  967.  vibrato, you can alter the rate, depth or both. Use command E4- to
  968.  change the vibrato-waveform.
  969.  
  970.  
  971.  
  972.  Cmd 5. ToneP + Volsl [Spd:$0-$F/$0-$F]
  973.  --------------------------------------
  974.  Usage: $5 + upspeed + downspeed
  975.  
  976.  This command will continue the current toneportamento and slide the volume
  977.  at the same time. Compatible with Noisetracker 2.0.
  978.  
  979.  Example: C-300503  3 is the speed to turn the volume down.
  980.  
  981.           C-300540  4 is the speed to slide it up.
  982.  
  983.  
  984.  
  985.  Cmd 6. Vibra + Volsl [Spd:$0-$F/$0-$F]
  986.  --------------------------------------
  987.  Usage: $6 + upspeed + downspeed
  988.  
  989.  This command will continue the current vibrato and slide the volume at the
  990.  same time. Compatible with Noisetracker 2.0.
  991.  
  992.  Example: C-300605  5 is the speed to turn the volume down.
  993.  
  994.           C-300640  4 is the speed to slide it up.
  995.  
  996.  
  997.  
  998.  Cmd 7. Tremolo [Rate:$0-$F,Dpth:$0-$F]
  999.  --------------------------------------
  1000.  Usage: $7 + tremolorate + tremolodepth
  1001.  
  1002.  Tremolo vibrates the volume.
  1003.  
  1004.  Example: C-300794  7 is the command, 9 is the speed of the tremolo,
  1005.                     and 4 is the depth of the tremolo.
  1006.  
  1007.  To keep on tremoling, just select the command $7 + 00. To change the
  1008.  tremolo, you can alter the rate, depth or both. Use command E7- to
  1009.  change the tremolo-waveform.
  1010.  
  1011.  
  1012.  
  1013.  Cmd 9. Set SampleOffset [Offs:$00-$FF]
  1014.  --------------------------------------
  1015.  Usage: $9 + Sampleoffset
  1016.  
  1017.  This command will play from a chosen position in the sample, and not from
  1018.  the beginning. The two numbers equal the two first numbers in the length
  1019.  of the sample. Handy for speech samples.
  1020.  
  1021.  Example: C-300923  Play sample from offset $2300.
  1022.  
  1023.  
  1024.  
  1025.  Cmd A. Volumeslide [Speed:$0-$F/$0-$F]
  1026.  --------------------------------------
  1027.  Usage: $A + upspeed + downspeed
  1028.  
  1029.  Example: C-300A05  5 is the speed to turn the volume down.
  1030.  
  1031.           C-300A40  4 is the speed to slide it up.
  1032.  
  1033.  NOTE: The slide will be called as many times as the speed of the song.
  1034.  The slower the song, the more the volume will be changed on each note.
  1035.  
  1036.  
  1037.  
  1038.  Cmd B. Position-jump [Pos:$00-$7F]
  1039.  ----------------------------------
  1040.  Usage: $B + position to continue at
  1041.  
  1042.  Example: C-300B01  B is the command, 1 is the position to
  1043.                     restart the song at.
  1044.  
  1045.  This command will also perform a pattern-break (see 2 pages below).
  1046.  
  1047.  You can use this command instead of restart as on Noisetracker, but you 
  1048.  must enter the position in hex!
  1049.  
  1050.  
  1051.  
  1052.  Cmd C. Set volume [Volume:$00-$40]
  1053.  ----------------------------------
  1054.  Usage: $C + new volume
  1055.  
  1056.  Well, this old familiar command will set the current volume to your own
  1057.  selected. The highest volume is $40. All volumes are represented in hex.
  1058.  (Programmers do it in hex, you know!)
  1059.  
  1060.  Example: C-300C10  C is the command, 10 is the volume (16 decimal).
  1061.  
  1062.  
  1063.  
  1064.  Cmd D. Pattern-break [Pattern-pos:00-63, decimal]
  1065.  -------------------------------------------------
  1066.  Usage: $D + pattern-position
  1067.  
  1068.  This command just jumps to the next song-position, and continues play
  1069.  from the patternposition you specify.
  1070.  
  1071.  Example: C-300D00  Jump to the next song-position and continue play
  1072.                     from patternposition 00.
  1073.       Or: C-300D32  Jump to the next song-position and continue play
  1074.                     from patternposition 32 instead.
  1075.  
  1076.  
  1077.  
  1078.  Cmd E0. Set filter [Range:$0-$1]
  1079.  --------------------------------
  1080.  Usage: $E0 + filter-status
  1081.  
  1082.  This command jerks around with the sound-filter on some A500 + A2000.
  1083.  All other Amiga-users should keep out of playing around with it.
  1084.  
  1085.  Example: C-300E01  disconnects filter (turns power LED off)
  1086.  
  1087.           C-300E00  connects filter (turns power LED on)
  1088.  
  1089.  
  1090.  
  1091.  Cmd E1. Fineslide up [Range:$0-$F]
  1092.  ----------------------------------
  1093.  Usage: $E1 + value
  1094.  
  1095.  This command works just like the normal portamento up, except that
  1096.  it only slides up once. It does not continue sliding during the length
  1097.  of the note.
  1098.  
  1099.  Example: C-300E11  Slide up 1 at the beginning of the note.
  1100.  
  1101.  (Great for creating chorus effects)
  1102.  
  1103.  
  1104.  
  1105.  Cmd E2. Fineslide down [Range:$0-$F]
  1106.  ------------------------------------
  1107.  Usage: $E2 + value
  1108.  
  1109.  This command works just like the normal portamento down, except that
  1110.  it only slides down once. It does not continue sliding during the length
  1111.  of the note.
  1112.  
  1113.  Example: C-300E26  Slide up 6 at the beginning of the note.
  1114.  
  1115.  
  1116.  
  1117.  Cmd E3. Glissando Ctrl [Range:$0-$1]
  1118.  ------------------------------------
  1119.  Usage: $E3 + Glissando-Status
  1120.  
  1121.  Glissando must be used with the tone-portamento command. When glissando is
  1122.  activated, toneportamento will slide a halfnote at a time, instead of a
  1123.  straight slide.
  1124.  
  1125.  Example: C-300E31  Turn Glissando on.
  1126.  
  1127.           C-300E30  Turn Glissando off.
  1128.  
  1129.  
  1130.  
  1131.  Cmd E4. Set vibrato waveform [Range:$0-$3]
  1132.  ------------------------------------------
  1133.  Usage: $E4 + vibrato-waveform
  1134.  
  1135.  Example: C-300E40  Set sine(default)
  1136.                E44  Don't retrig WF
  1137.           C-300E41  Set Ramp Down
  1138.                E45  Don't retrig WF
  1139.           C-300E42  Set Squarewave
  1140.                E46  Don't retrig WF
  1141.           C-300E43  Set Random
  1142.                E47  Don't retrig WF
  1143.  
  1144.  
  1145.  
  1146.  Cmd E5. Set finetune [Range:$0-$F]
  1147.  ----------------------------------
  1148.  Usage: $E5 + finetune-value
  1149.  
  1150.  Example: C-300E51  Set finetune to 1.
  1151.  
  1152.  Use these tables to figure out the finetune-value.
  1153.  
  1154.  Finetune: +7 +6 +5 +4 +3 +2 +1  0
  1155.     Value:  7  6  5  4  3  2  1  0
  1156.  
  1157.  Finetune: -1 -2 -3 -4 -5 -6 -7 -8
  1158.     Value:  F  E  D  C  B  A  9  8
  1159.  
  1160.  
  1161.  
  1162.  Cmd E6. PatternLoop [Loops:$0-$F]
  1163.  ----------------------------------
  1164.  Usage: $E6 + number of loops
  1165.  
  1166.  This command will loop a part of a pattern.
  1167.  
  1168.  Example: C-300E60  Set loopstart.
  1169.  
  1170.           C-300E63  Jump to loop 3 times before playing on.
  1171.  
  1172.  
  1173.  
  1174.  Cmd E7. Set tremolo waveform [Range:$0-$3]
  1175.  ------------------------------------------
  1176.  Usage: $E7 + tremolo-waveform
  1177.  
  1178.  Example: C-300E70  Set sine(default)
  1179.                E74  Don't retrig WF
  1180.           C-300E71  Set Ramp Down
  1181.                E75  Don't retrig WF
  1182.           C-300E72  Set Squarewave
  1183.                E76  Don't retrig WF
  1184.           C-300E73  Set Random
  1185.                E77  Don't retrig WF
  1186.  
  1187.  
  1188.  
  1189.  Cmd E9. Retrig note [Value:$0-$F]
  1190.  ---------------------------------
  1191.  Usage: $E9 + Tick to Retrig note at.
  1192.  
  1193.  This command will retrig the same note before playing the next. Where to
  1194.  retrig depends on the speed of the song. If you retrig with 1 in speed 6
  1195.  that note will be trigged 6 times in one note slot. Retrig on hi-hats!
  1196.  
  1197.  Example: C-300F06  Set speed to 6.
  1198.           C-300E93  Retrig at tick 3 out of 6.
  1199.  
  1200.  
  1201.  
  1202.  Cmd EA. FineVolsl up [Range:$0-$F]
  1203.  ----------------------------------
  1204.  Usage: $EA + value
  1205.  
  1206.  This command works just like the normal volumeslide up, except that
  1207.  it only slides up once. It does not continue sliding during the length
  1208.  of the note.
  1209.  
  1210.  Example: C-300EA3  Slide volume up 1 at the beginning of the note.
  1211.  
  1212.  
  1213.  
  1214.  Cmd EB. FineVolsl down [Range:$0-$F]
  1215.  ------------------------------------
  1216.  Usage: $EB + value
  1217.  
  1218.  This command works just like the normal volumeslide down, except that
  1219.  it only slides down once. It does not continue sliding during the length
  1220.  of the note.
  1221.  
  1222.  Example: C-300EB6  Slide volume down 6 at the beginning of the note.
  1223.  
  1224.  
  1225.  
  1226.  Cmd EC. Cut note [Value:$0-$F]
  1227.  ------------------------------
  1228.  Usage: $EC + Tick to cut note at.
  1229.  
  1230.  This command will cut the note at the selected tick, creating
  1231.  extremely short notes.
  1232.  
  1233.  Example: C-300F06  Set speed to 6.
  1234.           C-300EC3  Cut at tick 3 out of 6.
  1235.  
  1236.  Note that the note is not really cut, the volume is just turned down.
  1237.  
  1238.  
  1239.  
  1240.  Cmd ED. NoteDelay [Value:$0-$F]
  1241.  -------------------------------
  1242.  Usage: $ED + ticks to delay note.
  1243.  
  1244.  This command will delay the note to the selected tick.
  1245.  
  1246.  Example: C-300F06  Set speed to 6.
  1247.           C-300ED3  Play note at tick 3 out of 6.
  1248.  
  1249.  If you use ED0, the note will be delayed a little anyway.
  1250.  You can play the same note on two channels, delay one, and get a
  1251.  nice flanging effect.
  1252.  
  1253.  
  1254.  
  1255.  Cmd EE. PatternDelay [Notes:$0-$F]
  1256.  ----------------------------------
  1257.  Usage: $EE + notes to delay pattern.
  1258.  
  1259.  This command will delay the pattern the selected numbers of notes.
  1260.  
  1261.  Example: C-300EE8  Delay pattern 8 notes before playing on.
  1262.  
  1263.  All other effects are still active when the pattern is being delayed.
  1264.  
  1265.  
  1266.  
  1267.  Cmd EF. Invert Loop [Speed:$0-$F]
  1268.  ---------------------------------
  1269.  Usage: $EF + Invertspeed
  1270.  
  1271.  This command will need a short loop ($10,20,40,80 etc. bytes) to work.
  1272.  It will invert the loop byte by byte. Sounds better than funkrepeat...
  1273.  
  1274.  Example: C-300EF8 Set invspeed to 8.
  1275.  
  1276.  To turn off the inverting, set invspeed to 0, or press ctrl + Z.
  1277.  
  1278.  This effect will trash the sample, and will probably be removed in
  1279.  the next version.
  1280.  
  1281.  
  1282.  
  1283.  Cmd F. Set speed [Speed:$00-$FF]
  1284.  --------------------------------
  1285.  Usage: $F + speed
  1286.  
  1287.  This command will set the speed of the song.  
  1288.  
  1289. Vblank: Range 01-FF - Normal timing  
  1290.  
  1291.    CIA: Range 01-1F - Set vblank speeds
  1292.                       with CIA timing.
  1293.    CIA: Range 20-FF - Set BPM speeds,
  1294.                       range 32-255.
  1295.   Both: Range 00    - STOP song. 
  1296.  
  1297.  
  1298.  
  1299.  
  1300.                 KEYBOARD
  1301.                 --------
  1302.  The keymap on protracker is a standard us keymap. The font has been enhanced
  1303.  and redrawn a little, so you now have a lot more special characters than
  1304.  before. Remember to always use the left shift and alt, as the right ones
  1305.  are used for other things.
  1306.  
  1307.  High notekeys:  2 3   5 6 7   9 0   =
  1308.                 Q W E R T Y U I O P [ ]
  1309.                    
  1310.  Low notekeys:    S D   G H J   L ;
  1311.                  Z X C V B N M , . /
  1312.  
  1313.  F1 - Choose lo octave(From C-1 to G-3)
  1314.  F2 - Choose hi octave(From C-2 to B-3)
  1315.  
  1316.  shft+F3 - Cut track to buffer
  1317.  shft+F4 - Copy track to buffer
  1318.  shft+F5 - Paste track-buffer to track
  1319.  
  1320.   alt+F3 - Cut whole pattern to buffer
  1321.   alt+F4 - Copy whole pattern to buffer
  1322.   alt+F5 - Paste patt-buffer to pattern
  1323.  
  1324.  ctrl+F3 - Cut commands to buffer
  1325.  ctrl+F4 - Copy commands to buffer
  1326.  ctrl+F5 - Paste cmd-buffer to track
  1327.  
  1328.  F6 - Go to patternposition 0
  1329.  F7 - Go to patternposition 16
  1330.  F8 - Go to patternposition 32
  1331.  F9 - Go to patternposition 48
  1332.  F10- Go to patternposition 63
  1333.  
  1334.  shft+F6-F10 - Store current patternposition on selected F-key
  1335.   alt+F6-F10 - Play pattern from the stored patternposition
  1336.  ctrl+F6-F10 - Record from the stored patternposition
  1337.  
  1338. Esc - Exit DiskOp/EditOp/PLST/PsetEd/Setup/Help etc...
  1339.  
  1340.  shft+Return  - Insert blank note at cursorposition and move
  1341.                 the others down. Notes beyond patternposition
  1342.                 63 will be lost!
  1343.  shft+Bckspce - Delete note above cursorposition and move
  1344.                 the others up. You can NOT do this if you're
  1345.                 at patternposition 0!
  1346.  
  1347.  alt+Return    - As above, but with all 4 tracks
  1348.  alt+Backspace - As above, but with all 4 tracks
  1349.  
  1350.  ctrl+Return    - Push cmds one down
  1351.  ctrl+Backspace - Drag cmds one up
  1352.  
  1353.  ctrl+0-9 - Select how many slots PT will jump down each time
  1354.             you insert a note (this is only in Edit-mode)
  1355.  
  1356.   alt+cursor right - patternnumber up
  1357.   alt+cursor left  - patternnumber down
  1358.  shft+cursor right - song-position up
  1359.  shft+cursor left  - song-position down
  1360.  
  1361.  BackwardsSingleQuote (The key over TAB, you know?) - Go to CLI
  1362.  
  1363.       Help - Go to help or plst screen
  1364.  shft+Help - Toggle between Help or PLST on Help key
  1365.  
  1366.  Space - Toggle between Stop/Edit-mode
  1367.  
  1368.  < (beside Z) - Kill DMA & Volumes to 0
  1369.   right Amiga - Play Pattern
  1370.     right Alt - Play Song
  1371.   right Shift - Record
  1372.     Caps Lock - Toggle Keyrepeat on/off
  1373.  
  1374.       Del - Delete note under cursor
  1375.   alt+Del - Delete command only 
  1376.  shft+Del - Delete note and command
  1377.  
  1378.  On Numeric pad:
  1379.  
  1380.           0 - Select Sample $0
  1381.     1st row - Select Sample $1-$4
  1382.     2nd row - Select Sample $5-$8
  1383.     3rd row - Select Sample $9-$c
  1384.     4th row - Select Sample $d-$f
  1385.  Just Enter - Select Sample $10
  1386.  
  1387.  Holding Enter + the other keys, will select sample $11-$1F
  1388.  
  1389.  Period (.) - Kill current sample
  1390.  
  1391.  Left Amiga (Plus keys below) - Transposing like in Edit Op. Screen 1
  1392.  
  1393.    Sample/Track        Sample/Pattern
  1394.    ----------------------------------
  1395.    1 - Note Up         2 - Note Up
  1396.    Q - Note Down       W - Note Down
  1397.    A - Octave Up       S - Octave Up
  1398.    Z - Octave Down     X - Octave Down
  1399.  
  1400.    All/Track           All/Pattern
  1401.    -------------------------------
  1402.    3 - Note Up         4 - Note Up
  1403.    E - Note Down       R - Note Down
  1404.    D - Octave Up       F - Octave Up
  1405.    C - Octave Down     V - Octave Down
  1406.  
  1407.       Tab - Move cursor to next track
  1408.  Shft+Tab - Move cursor to prev track
  1409.  
  1410.  Ctrl+A - Toggle channel on/off
  1411.  Ctrl+B - Mark block
  1412.  Ctrl+C - Copy block to buffer
  1413.  Ctrl+D - Delete block, drag notes up
  1414.  Ctrl+e - expand track
  1415.  Ctrl+f - toggle filter on/off
  1416.  Ctrl+g - Boost all samples
  1417.  Ctrl+h - Transpose block up
  1418.  Ctrl+i - Insert block, push notes down
  1419.  Ctrl+j - Join-paste block
  1420.  Ctrl+k - Kill to end of track
  1421.  Ctrl+l - Transpose block down
  1422.  Ctrl+m - Toggle multikeyboard on/off
  1423.  Ctrl+n - Re-mark last block
  1424.  Ctrl+o - Contract track
  1425.  Ctrl+p - Paste block
  1426.  Ctrl+q - Unmute all channels
  1427.  Ctrl+r - Restore F6-F10 positions
  1428.  Ctrl+s - Toggle split keyboard on/off
  1429.  Ctrl+t - swap tracks
  1430.  Ctrl+u - undo last change
  1431.  Ctrl+v - Filter all samples
  1432.  Ctrl+w - Polyphonize block
  1433.  Ctrl+x - Cut block to buffer
  1434.  Ctrl+y - Backwards block
  1435.  Ctrl+z - Restore Effects
  1436.  
  1437.  shft+0-9 - Store current command on selected key
  1438.   alt+0-9 - Insert command in current track
  1439.  
  1440.   alt+"\" - Copy command above cursor to current patternposition.
  1441.   alt+"=" - Copy command above cursor to current patternposition
  1442.             and add one to the value.
  1443.   alt+"-" - Copy command above cursor to current patternposition
  1444.             and subract one from the value.
  1445.  
  1446.   alt+A - Monitor/Start sampling
  1447.   alt+B - Boost sample
  1448.   alt+C - Toggle channel 3
  1449.   alt+D - Go to Disk Op.
  1450.   alt+E - Go to Edit Op.
  1451.   alt+F - Filter sample
  1452.   alt+I - Autoinsert volume
  1453.   alt+K - Delete current sample/track
  1454.   alt+Q - Quit protracker
  1455.   alt+R - Resample
  1456.   alt+S - Go to Sampler screen
  1457.   alt+T - Tuning Tone
  1458.   alt+V - Toggle channel 4
  1459.   alt+X - Toggle channel 2
  1460.   alt+Z - Toggle channel 1
  1461.  
  1462.   F3 - Cut   (sample)
  1463.   F4 - Copy  (sample)
  1464.   F5 - Paste (sample)
  1465.  
  1466.       \ - Toggle keypad mode (dots!)
  1467.  Return - Step one note forward
  1468.  Backspc- Step one note backward
  1469.   Alt+any key on keypad - tune drumpad
  1470.  ctrl+arrows left/rite - Sample up/down     
  1471.  
  1472.  
  1473.  
  1474.  
  1475.              GENERAL INFO.
  1476.              -------------
  1477.  Making Music
  1478.  ------------
  1479.  Any piece of music written with Protracker is built up from patterns.
  1480.  Each pattern is built up from four tracks, one for each of the amiga's
  1481.  audiochannels.
  1482.  
  1483.  A pattern is 64 lines long. The magnified line is always the one you edit.
  1484.  If you need shorter patterns, use the patternbreak effect command.
  1485.  
  1486.  A track is built up like this:
  1487.  
  1488.      32  C-3 01 C20
  1489.      /   \_/ |/ \_/
  1490.     /    /   |    \
  1491.   Pos Note Sample Effect cmd.
  1492.  
  1493.  The C-3 is the note being played at patternposition 32. 01 is the sample-
  1494.  number, and the three last digits are the effect command, in this case, set
  1495.  volume to $20 (C-Command, 20-Value).
  1496.  
  1497.  Protracker holds a table with info about the sequence in which the patt-
  1498.  erns will be played. With the "Pos" gadget you determine your position in
  1499.  the table. With "Pattern" you define what pattern to play at that position.
  1500.  "Length" defines the total size of the table. The full sequence of Patterns
  1501.  is the Song. A song is built up from up to 64 different patterns, each
  1502.  being played at up to 128 different positions.
  1503.  
  1504.  The small gadgets labeled "I" and "D" are Insert and Delete. With them you
  1505.  can Insert or Delete a position from your song. The length of your song
  1506.  will be adjusted automatically. Remember that the length of your song
  1507.  always must be one more than the last position, since the first position
  1508.  is 0.
  1509.  
  1510.  Holding down the right button when pressing the Pos, Pattern and Length
  1511.  gadgets will speed them up a bit.
  1512.  
  1513.  
  1514.  Finetune
  1515.  --------
  1516.  This is a goodie. Tune your untuned samples to match the others. Right
  1517.  button will set finetune to zero.
  1518.  
  1519.      0 436.4 hz    -1 432.1 hz
  1520.      1 439.0 hz    -2 429.6 hz
  1521.      2 441.6 hz    -3 426.3 hz
  1522.      3 445.1 hz    -4 423.1 hz
  1523.      4 447.8 hz    -5 419.9 hz
  1524.      5 451.5 hz    -6 416.7 hz
  1525.      6 455.2 hz    -7 414.4 hz
  1526.      7 457.0 hz    -8 412.0 hz
  1527.  
  1528.  
  1529.  Sample 
  1530.  ------
  1531.  Clicking on the sample up/down gadgets will flicker through the
  1532.  samples. You can use up to 31, or hex $1F samples in a song.
  1533.  
  1534.  Sample zero function
  1535.  --------------------
  1536.  Pressing both mousebuttons at the same time will set the samplenumber
  1537.  to zero. You can then record the pattern with sample 0 to prevent
  1538.  Protracker from setting the volume each time you play a new note.
  1539.  
  1540.  Length
  1541.  ------
  1542.  The Length gadgets are simply used for setting the length of the sample.
  1543.  A sample can be up to 64k, or $fffe long. You can add workspace behind
  1544.  the sample by increasing the length and letting go of the button. PT will
  1545.  ask if you are sure, and if you are, allocate more memory for the sample.
  1546.  
  1547.  Volume
  1548.  ------
  1549.  Use this to set the volume the current sample will be played with.
  1550.  
  1551.  Repeat
  1552.  ------
  1553.  Here you set the start of the sampleloop.
  1554.  
  1555.  Replen
  1556.  ------
  1557.  Here you set the length of the sampleloop.
  1558.  
  1559.  Pressing both the left aaaand right button on the sample-gadgets will
  1560.  speed them up a bit.
  1561.  
  1562.  The PatternNumber Gadget
  1563.  ------------------------
  1564.  To the middle left of the screen is a box with a number in it. The number
  1565.  is the current pattern number. Click on it to type in a new number. When
  1566.  in type-in mode, use return, ESC or right mousebutton to exit. This should
  1567.  also work on most other such gadgets.
  1568.  
  1569.  The "Are you sure ?" requester
  1570.  ------------------------------
  1571.  In addition to the gadgets, you can use "Y" or Return for Yes,
  1572.  and "N" or ESC for No.
  1573.  
  1574.  The Clear requester
  1575.  -------------------
  1576.  In addition to the gadgets you can use "A" for All, "O" for Song, "S" for
  1577.  samples and "C" or ESC for Cancel.
  1578.  
  1579.  The Load (sample) gadget
  1580.  ------------------------
  1581.  This gadget will simply try to load the current samplename. Use this when
  1582.  you've fucked up in the sample editor, and have destroyed a sample.
  1583.  
  1584.  The text-input routine
  1585.  ----------------------
  1586.  Now this is really simple. Clicking on a textline will enable you to edit
  1587.  it. Some text lines are longer than they seem, so use the arrowkeys to
  1588.  scroll back and forth in the text. The text input mode is just like an
  1589.  ordinary text editor. You can use backspace, delete, space and such.
  1590.  In text-input mode you can also use the numeric pad for entering numbers.
  1591.  Pressing the right mousebutton will clear the textline and exit the editing.
  1592.  Use ESC or return to just exit.
  1593.  
  1594.  
  1595.  Tips 'n tricks
  1596.  --------------
  1597.  When inserting, pasting or join-pasting, hold down shift to keep the
  1598.  cursor from jumping to the end of the block. e.g. shft+ctrl+P
  1599.  
  1600.  Holding shift while pressing ctrl+K (kill to end of track) will kill to
  1601.  start of track instead.
  1602.  
  1603.  Use Esc or right mousebutton to exit from a lot of things.
  1604.  
  1605.  
  1606.  Effect tips
  1607.  -----------
  1608.  You can set the volume without playing a note. e.g. ---01000
  1609.  This will set the volume for sample 1 without trigging the note.
  1610.  
  1611.  Or try trigging the sample and sliding
  1612.  the volume down. e.g. C-301A08
  1613.                        ---01A08
  1614.                        ---01A08
  1615.  This will create a strange arpeggiato effect, like on "Cream of the earth"
  1616.  by Romeo Knight / RSI.
  1617.  
  1618.  
  1619.  Pointer Colors
  1620.  --------------
  1621.  
  1622.  Gray      - Nothin's happening.
  1623.  Yellow    - Playing song / pattern.
  1624.  Green     - Disk action.
  1625.  Blue      - Edit / record.
  1626.  Magenta   - Waiting for something (text, number or something else).
  1627.  Cyan      - Select entry or delete.
  1628.  Red       - Something went wrong.
  1629.  
  1630.  
  1631.  Drumpad
  1632.  -------
  1633.  Protracker 1.1 features a drumpad as in Noisetracker 2.0 and 2.1.
  1634.  Use backspace '\' instead of period '.' to toggle modes. One or
  1635.  more dots will appear to the right of the freemem display.
  1636.  
  1637.  No dots: Normal keypad.
  1638.    1 dot: Drumpad.
  1639.   2 dots: Drumpad - Edit/Rec possible.
  1640.  
  1641.  Use Alt + keypad key to set note.
  1642.  
  1643.  
  1644. /* End of File */
  1645.  
  1646.